Skip to content

fix: align genadoc.java aesh version and add --format option - #2699

Merged
maxandersen merged 1 commit into
jbangdev:mainfrom
maxandersen:fix/genadoc-aesh-version
Nov 4, 2026
Merged

maxandersen merged 1 commit into
jbangdev:mainfrom
maxandersen:fix/genadoc-aesh-version

Conversation

@maxandersen

Copy link
Copy Markdown
Collaborator

docs/genadoc.java pinned org.aesh:aesh:3.16.4 while jbang builds with 3.18.1, so CLI docs were generated by an older generator (no SKILL format, no format-aware help-section hooks).

  • Bump to 3.18.1 to match build.gradle.
  • Add --format asciidoc|markdown|skill (default asciidoc, so ./gradlew clidoc output is unchanged; nav.adoc is only written for AsciiDoc).
jbang --cp build/install/jbang/bin/jbang.jar docs/genadoc.java -d out --format skill dev.jbang.cli.JBang

docs/genadoc.java pinned aesh 3.16.4 while jbang uses 3.18.1, so docs
were generated with an older generator (no SKILL format, no
format-aware HelpSectionProvider hooks). Bump to 3.18.1 and add
--format asciidoc|markdown|skill (default asciidoc, so the clidoc task
output is unchanged).
@maxandersen
maxandersen merged commit 8868142 into jbangdev:main Nov 4, 2026
4 of 5 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant